====== urnStatus() ======

''array **urnStatus**(string //urnIDs//)''

The function ''urnStatus()'' returns information regarding the status of the urns specified.

  * //urnIDs//\\ The ID of the urn whose status is to be retrieved. 

===== Return Value =====

If an error occurs, for example, if there is no urn with the ID specified, the function returns ''false''. Otherwise, an array is returned with the following keys:

^Index^Meaning^
|elements|Number of ballots (elements) in the urn|
|drawn|Number of overall ballots already drawn and stored|
|round|Number of time the urn has been emptied (begins with 1), corresponding to the return value of ''urnDraw()''|
|done|Numer of ballots already drawn __in the current round__. If all ballots have been drawn from the urn, the next round commences and the number of ballots drawn is reset to 0|
|togo|Number of ballots __in the current round__ that can still be drawn. If this number reaches 0, a new round begins and the value is reset to the number of ballots|

===== Example =====

<code php>
$info = urnStatus('urn1');
html('<p>Still '.$info['togo'].' out of '.$info['elements'].' prize codes available.</p>');
</code>